В последних дистрибутивах Linux, FreeCAD, как правило, собирается легко, поскольку все зависимости обычно предоставляются менеджером пакетов. В основном сборка включает 3 этапа:
cmake
и компиляция с помощью make
.Ниже вы найдете подробное описание процесса сборки, некоторых скриптов компиляции и особенностей, с которыми Вы можете столкнуться. Если вы найдете ошибки, устаревшие сведения (дистрибутивы Linux меняются быстро), или если вы используете дистрибутив, которого нет в списке, обсудите вопрос на форуме, и помогите нам исправить это.
Общий рабочий процесс для компиляции FreeCAD из исходников. В систем должны быть как сторонние зависимости, так и исходные коды самого FreeCAD. CMake конфигурирует систему так чтобы весь проект скомпилировался одной инструкцией make.
Лучший способ получить код это клонировать Git репозиторий Git только-для-чтения. Для этого вам потребуется программа git
, которую легко установить в большинство дистрибутивов Linux. Скачать её можно на официальном веб-сайте.
Git может быть установлен, следующей командой:
sudo apt install git
Следующая команда, копирует последнюю версию исходного кода FreeCAD в папку freecad-source
.
git clone --recurse-submodules https://github.com/FreeCAD/FreeCAD.git freecad-source
Дополнительная информация о применении Git и внесении кода в проект изложена на странице управление исходным кодом.
Для компиляции FreeCAD необходимо установить требуемые зависимости (dependencies), упомянутые в сторонних библиотеках; пакеты, содержащие эти зависимости для различных дистрибутивов Linux, перечислены ниже. Обратите внимание, что имена и доступность библиотек будут зависеть от вашего конкретного дистрибутива; если ваш дистрибутив устарел, некоторые пакеты могут быть недоступны или иметь другое имя. В этом случае посмотрите раздел ↓ старые и нестандартные дистрибутивы расположенный ниже.
Как только у вас будут установлены все зависимости, приступайте к сборке FreeCAD.
Обратите внимание, что размер исходного кода FreeCAD составляет около 500 МБ; он может быть в три раза больше, если вы клонируете репозиторий Git со всей историей его изменений. Для получения всех зависимостей может потребоваться загрузка 500 МБ или более новых файлов; при распаковке этих файлов может потребоваться 1500 МБ или более места. Также имейте в виду, что в процессе компиляции может быть создано до 1500 МБ дополнительных файлов, поскольку система копирует и изменяет весь исходный код. Поэтому при попытке компиляции убедитесь, что на вашем жестком диске достаточно свободного места, по крайней мере, не менее 4 ГБ.
В системах основанных на Debian (Debian, Ubuntu, Mint, и т.п.) довольно легко установить все необходимые зависимости. Большинство библиотек доступны через apt
или менеджер пакетов Synaptic.
Если вы уже установили FreeCAD из официальных репозиториев, вы можете установить зависимости (dependencies) для его сборки с помощью этой единственной строки кода в терминале:
sudo apt build-dep freecad
Alternatively, replace freecad
with freecad-daily
to install the build dependencies for the main development branch. You'll need to have the freecad-stable/freecad-daily PPAs added to your software sources.
Однако, если версия FreeCAD в репозиториях старая, зависимости (dependencies) могут быть уже устаревшими для компиляции последней версии FreeCAD. Поэтому, пожалуйста, убедитесь, что вы установили следующие пакеты.
Эти пакеты необходимы для успешной компиляции в целом:
build-essential
, устанавливает компиляторы C и C++ , библиотеки разработки C и make
утилиту.cmake
, необходимый инструмент для настройки исходников FreeCAD. Вы также можете установить cmake-gui
и cmake-curses-gui
чтобы иметь графический интерфейс для данной утилиты.libtool
, необходимые инструменты для создания shared библиотек.lsb-release
, стандартная утилита базовой отчетности обычно уже установлена в системе Debian и позволяет программно различать чистую установку Debian или ее вариант, такой как Ubuntu или Linux Mint. Не удаляйте этот пакет, так как от него могут зависеть многие другие системные пакеты.При компиляции FreeCAD используется язык Python, и он также используется в runtime в качестве языка сценариев. Если вы используете дистрибутив на основе Debian, интерпретатор Python как правило уже установлен в нем.
python3
swig
, это инструмент, который создает интерфейсы между кодом C++ и Python.Пожалуйста, убедитесь, что у вас установлен Python 3. Python 2 устарел в 2019 году, свежая разработка FreeCAD не тестируется с этой версией языка.
Boost библиотеки должны быть обязательно установлены:
libboost-dev
libboost-date-time-dev
libboost-filesystem-dev
libboost-graph-dev
libboost-iostreams-dev
libboost-program-options-dev
libboost-python-dev
libboost-regex-dev
libboost-serialization-dev
libboost-thread-dev
Должны быть установлены Coin библиотеки:
libcoin80-dev
, для Debian Jessie, Stretch, Ubuntu с 16.04 до 18.10, илиlibcoin-dev
, для Debian Buster, Ubuntu 19.04 и выше, а так же Ubuntu 18.04/18.10 вместе с freecad-stable/freecad-daily PPAs должны быть добавлены в иходники.Несколько библиотек, которые занимаются вычислениями, триангулированными поверхностями, сортировкой, мешами (meshes), компьютерным зрением, картографическими проекциями, 3D-визуализацией, оконной системой X11, парсингом XML и чтением Zip-файлов:
libeigen3-dev
libgts-bin
libgts-dev
libkdtree++-dev
libmedc-dev
libopencv-dev
or libcv-dev
libproj-dev
libvtk9-dev
, libvtk8-dev
, libvtk7-dev
or libvtk6-dev
libx11-dev
libxerces-c-dev
libyaml-cpp-dev
libzipios++-dev
Python 2 и Qt4 уже устарели и не рекомендуются к применению. Начиная с версии 0.20, в FreeCAD они больше не поддерживаются.
При компиляции FreeCAD в Debian Jessie, Stretch, Ubuntu 16.04, используйте Python 2 и Qt4, установив следующие зависимости:
qt4-dev-tools
libqt4-dev
libqt4-opengl-dev
libqtwebkit-dev
libshiboken-dev
libpyside-dev
pyside-tools
python-dev
python-matplotlib
python-pivy
python-ply
python-pyside
При компиляции FreeCAD в Debian Buster, Ubuntu 19.04 и выше, а также Ubuntu 18.04/18.10 с freecad-stable/freecad-daily PPAs добавленным в ваш исходный код, установите следующие зависимости.
qtbase5-dev
qttools5-dev
qt5-default
(if compiling 0.20 on a machine that still has Qt4)libqt5opengl5-dev
libqt5svg5-dev
qtwebengine5-dev
libqt5xmlpatterns5-dev
libqt5x11extras5-dev
libpyside2-dev
libshiboken2-dev
pyside2-tools
pyqt5-dev-tools
python3-dev
python3-matplotlib
python3-packaging
python3-pivy
python3-ply
python3-pyside2.qtcore
python3-pyside2.qtgui
python3-pyside2.qtsvg
python3-pyside2.qtwidgets
python3-pyside2.qtnetwork
python3-pyside2.qtwebengine
python3-pyside2.qtwebenginecore
python3-pyside2.qtwebenginewidgets
python3-pyside2.qtwebchannel
python3-pyside2uic
(not required on Ubuntu 20.04 and later)
Ядро OpenCascade - это основная графическая библиотека для создания 3D-фигур. Она существует в виде официальной версии OCCT и виде версии для сообщества OCE. Версия для сообщества к применению больше не рекомендуется, так как она устарела.
Для Debian Buster и Ubuntu 18.10 и выше, а так же для Ubuntu 18.04 с freecad-stable/freecad-daily PPAs добавлеными в ваши исходники, установите официальные пакеты.
libocct*-dev
libocct-data-exchange-dev
libocct-draw-dev
libocct-foundation-dev
libocct-modeling-algorithms-dev
libocct-modeling-data-dev
libocct-ocaf-dev
libocct-visualization-dev
occt-draw
Для Debian Jessie, Stretch, Ubuntu 16.04 и выше, установите community edition пакеты.
liboce*-dev
liboce-foundation-dev
liboce-modeling-dev
liboce-ocaf-dev
liboce-ocaf-lite-dev
liboce-visualization-dev
oce-draw
Вы можете установить библиотеки по отдельности или сразу несколько с похожим именами используя символ звездочку '*'. Замените occ
на oce
если вы хотите установить community редакцию библиотек.
sudo apt install libocct*-dev
При желании вы также можете установить эти дополнительные пакеты:
libsimage-dev
, чтобы Coin поддерживал дополнительные форматы файлов изображений.doxygen
и libcoin-doc
(или libcoin80-doc
для старых систем), если вы хотите автоматический генерировать документацию к исходному коду.libspnav-dev
, для поддержки устройств 3D ввода, таких как 3Dconnexion "Space Navigator" или "Space Pilot".checkinstall
, если вы хотите зарегистрировать установленные файлы в диспетчере пакетов вашей системы, чтобы вы могли удалить их позже.
Требуется, чтобы Pyside2 был доступен в Debian buster и freecad-stable/freecad-daily PPAs.
sudo apt install cmake cmake-gui libboost-date-time-dev libboost-dev libboost-filesystem-dev libboost-graph-dev libboost-iostreams-dev libboost-program-options-dev libboost-python-dev libboost-regex-dev libboost-serialization-dev libboost-thread-dev libcoin-dev libeigen3-dev libgts-bin libgts-dev libkdtree++-dev libmedc-dev libocct-data-exchange-dev libocct-ocaf-dev libocct-visualization-dev libopencv-dev libproj-dev libpyside2-dev libqt5opengl5-dev libqt5svg5-dev qtwebengine5-dev libqt5x11extras5-dev libqt5xmlpatterns5-dev libshiboken2-dev libspnav-dev libvtk7-dev libx11-dev libxerces-c-dev libzipios++-dev occt-draw pyside2-tools python3-dev python3-matplotlib python3-packaging python3-pivy python3-ply python3-pyside2.qtcore python3-pyside2.qtgui python3-pyside2.qtsvg python3-pyside2.qtwidgets python3-pyside2.qtnetwork python3-pyside2.qtwebengine python3-pyside2.qtwebenginecore python3-pyside2.qtwebenginewidgets python3-pyside2.qtwebchannel python3-markdown python3-git python3-pyside2uic qtbase5-dev qttools5-dev swig libyaml-cpp-dev
ПРИМЕЧАНИЕ: В некоторых версиях Ubuntu и некоторых версиях Qt вы получите сообщение об ошибке, что python3-pyside2uic не может быть найден-в этих системах вы можете безопасно опустить его. В Ubuntu 20.04 вам нужно будет добавить pyqt5-dev-tools
. Более подробную информацию можно найти в это обсуждение на форуме.
Это не рекомендуется для более новых установок, поскольку и Python 2 и Qt4 являются устаревшими.
sudo apt install cmake debhelper dh-exec dh-python libboost-date-time-dev libboost-dev libboost-filesystem-dev libboost-graph-dev libboost-iostreams-dev libboost-program-options-dev libboost-python-dev libboost-regex-dev libboost-serialization-dev libboost-thread-dev libcoin80-dev libeigen3-dev libgts-bin libgts-dev libkdtree++-dev libmedc-dev libocct-data-exchange-dev libocct-ocaf-dev libocct-visualization-dev libopencv-dev libproj-dev libpyside-dev libqt4-dev libqt4-opengl-dev libqtwebkit-dev libshiboken-dev libspnav-dev libvtk6-dev libx11-dev libxerces-c-dev libzipios++-dev lsb-release occt-draw pyside-tools python-dev python-matplotlib python-pivy python-ply swig
Пользователи Ubuntu 16.04, пожалуйста, ознакомьтесь также с обсуждением компиляции на форуме: Компиляция в Linux (Kubuntu): CMake не может найти VTK.
Выполните те же действия, что и в Debian и Ubuntu.
Сообщалось о проблемах при попытке компиляции в Raspbian с Python 3 и Qt5, но комбинация Python 3 и Qt4, похоже, работает для более старых версий FreeCAD.
Для более новых версий FreeCAD компиляция с Py3/Qt5 проходит успешно, если установлена операционная система Ubuntu 20.04.
Из-за различных проблем с Qt в этой версии обычные PySide tools не будут найдены.
E: Unable to locate package python3-pyside2uic
В этом случае мы можем установить пакеты из PyQt и создать символические ссылки на необходимые инструменты.
sudo apt-get install pyqt5-dev
sudo apt-get install pyqt5-dev-tools
cd /usr/bin/
ln -s pyrcc5 pyside2-rcc
ln -s pyuic5 pyside2-uic
Теперь компиляция может быть продолжена.
cd build/
cmake ../ -DBUILD_QT5=ON -DPYTHON_EXECUTABLE=/usr/bin/python3 -DUSE_PYBIND11=ON
make -j2
Параметр -j
для make
не должен превышать 3, поскольку Raspberry Pi имеет ограниченную память. На компиляцию уйдет несколько часов, поэтому лучше сделать это за ночь.
Дополнительная информация, FreeCAD и Raspberry Pi 4.
There is a bug in cmake distributed by Fedora 34/35 which results in cmake failing to find the opencascade libraries. This can easily be fixed by making one minor change to the top level cmake file of opencascade installed on Fedora. Details here: https://bugzilla.redhat.com/show_bug.cgi?id=2083568.
Near the top of the file OpenCASCADEConfig.cmake, change the following line to use REAL_PATH()
. This fixes a bug introduced by the use of a symlink from /lib
to /usr/lib
of Fedora, which causes cmake to fail.
This file is usually installed in /usr/lib64/cmake/opencascade/OpenCASCADEConfig.cmake.
get_filename_component (OpenCASCADE_INSTALL_PREFIX "${OpenCASCADE_INSTALL_PREFIX}" PATH)
change this to:
file (REAL_PATH ${OpenCASCADE_INSTALL_PREFIX} OpenCASCADE_INSTALL_PREFIX)
This trivial change needs to be made inside the build directory once cmake has been run and failed. Re-running cmake will then correctly detect the OCCT libraries in the normal way.
Now install Python 3.11. This includes a notable change in how Python initializes when running a program. As a result FreeCAD fails to find OpenCamLib, meaning 3D Surface and Waterline are not available in the CAM Workbench. This was fixed in the master branch on 20th Mar 2024 (Pull request #13059).
Вам нужны следующие пакеты :
gcc-c++
(or possibly another C++ compiler?)cmake
doxygen
swig
gettext
dos2unix
desktop-file-utils
libXmu-devel
freeimage-devel
mesa-libGLU-devel
opencascade-devel
openmpi-devel
python3
python3-devel
python3-pyside2
python3-pyside2-devel
pyside2-tools
boost-devel
tbb-devel
eigen3-devel
qt-devel
qt5-qtwebengine-devel
qt5-qtxmlpatterns
qt5-qtxmlpatterns-devel
qt5-qtsvg-devel
qt5-qttools-static
ode-devel
xerces-c
xerces-c-devel
opencv-devel
smesh-devel
Coin3
Coin3-devel
yaml-cpp
(Не перепутайте "Coin" с "coin" - тот что с маленькой буквы это финансовый пакет. Апрельские Coin4 и Coin4-devel 2021 уже доступны) (если coin2 является последней доступной версией для вашей версии Fedora, используйте пакеты из http://www.zultron.com/rpm-repo/)
SoQt-devel
freetype
freetype-devel
vtk
vtk-devel
med
med-devel
Можете добавить, если требуется:
To install all dependencies at once (tested on fedora 36 and 37):
sudo dnf install gcc-c++ cmake doxygen swig gettext dos2unix desktop-file-utils libXmu-devel freeimage-devel mesa-libGLU-devel opencascade-devel openmpi-devel python3 python3-devel python3-pyside2 python3-pyside2-devel pyside2-tools boost-devel tbb-devel eigen3-devel qt-devel qt5-qtwebengine-devel qt5-qtxmlpatterns qt5-qtxmlpatterns-devel qt5-qtsvg-devel qt5-qttools-static ode-devel xerces-c xerces-c-devel opencv-devel smesh-devel Coin3 Coin3-devel SoQt-devel freetype freetype-devel vtk vtk-devel med med-devel libspnav-devel python3-pivy python3-markdown python3-GitPython yaml-cpp
Простейший путь проверить, какие пакеты нужны для компиляции FreeCAD это проверить через portage:
emerge -pv freecad
Вы получите список дополнительных пакетов, которые следует установить на Вашей системе.
Если FreeCAD недоступен в portage, он доступен в оверлее waebbl. Система отслеживания ошибок на оверлее waebbl Github может помочь решить некоторые проблемы, с которыми вы можете столкнуться. Оверлей предоставляет freecad-9999, который вы можете выбрать для компиляции или просто использовать для получения зависимостей.
layman -a waebbl
Следующие команды установят пакеты, необходимые для создания FreeCAD с Qt5 и Python 3.
zypper in --no-recommends -t pattern devel_C_C++ devel_qt5
zypper in libqt5-qtbase-devel libqt5-qtsvg-devel libqt5-qttools-devel boost-devel swig libboost_program_options-devel libboost_mpi_python3-devel libboost_system-devel libboost_program_options-devel libboost_regex-devel libboost_python3-devel libboost_thread-devel libboost_system-devel libboost_headers-devel libboost_graph-devel python3 python3-devel python3-matplotlib python3-matplotlib-qt5 python3-pyside2 python3-pyside2-devel python3-pivy gcc gcc-fortran cmake occt-devel libXi-devel opencv-devel libxerces-c-devel Coin-devel SoQt-devel freetype2-devel eigen3-devel libode6 vtk-devel libmed-devel hdf5-openmpi-devel openmpi2-devel netgen-devel freeglut-devel libspnav-devel f2c doxygen dos2unix glew-devel yaml-cpp
Следующая команда установит Qt Creator и отладчик проекта GNU.
zypper in libqt5-creator gdb
Если какие-либо пакеты отсутствуют, вы можете проверить Tumbleweed [1] "FreeCAD.spec" файл на [2] Откройте Службу сборки.
Также, проверьте, есть ли какие-либо исправления, которые вам необходимо использовать (например 0001-find-openmpi2-include-files.patch).
Если есть разница между доступными пакетами на Tumbleweed и Leap, то вы можете прочитать Leap [3] файл "FreeCAD.spec" на [4] Откройте службу сборки, чтобы определить необходимые пакеты.
Смотрите piano_jonas unofficial "Compile On openSUSE" guide.
Вам понадобятся следующие библиотеки из официальных архивов:
boost
cmake
coin
curl
desktop-file-utils
eigen
gcc-fortran
git
glew
hicolor-icon-theme
jsoncpp
libspnav
med
nlohmann-json
opencascade
pyside2-tools
pyside2
python-matplotlib
python-netcdf4
python-packaging
python-pivy
qt5-svg
qt5-tools
qt5-webengine
shared-mime-info
shiboken2
swig
utf8cpp
verdict
xerces-c
yaml-cpp
sudo pacman -S --needed --asdeps boost cmake coin curl desktop-file-utils eigen gcc-fortran git glew hicolor-icon-theme jsoncpp libspnav med nlohmann-json opencascade python-matplotlib python-netcdf4 python-packaging python-pivy qt5-svg qt5-tools qt5-webengine shared-mime-info swig utf8cpp xerces-c yaml-cpp
FreeCAD currently uses QT5. This requires packages which have been moved from the official repositories to the AUR. These packages will be compiled by source and may take a long time depending on the available hardware.
yay -S --needed --asdeps pyside2 pyside2-tools shiboken2
В других дистрибутивах у нас очень мало отзывов от пользователей, поэтому может быть сложнее найти необходимые пакеты.
Сначала попробуйте найти необходимые библиотеки, упомянутые в сторонние библиотеки в диспетчере пакетов. Остерегайтесь, что у некоторых из них может быть немного другое имя пакета; ищите name
, но также libname
, name-dev
, name-devel
и аналогичные. Если это невозможно, попробуйте скомпилировать эти библиотеки самостоятельно.
Для FreeCAD требуется версия компилятора GNU g++, равная или выше 3.0.0, так как FreeCAD в основном написан на C++. Во время компиляции выполняются некоторые сценарии Python, поэтому интерпретатор Python должен работать должным образом. Чтобы избежать каких-либо проблем с компоновщиком, также рекомендуется иметь пути к библиотеке в переменной LD_LIBRARY_PATH
или в файле ld.so.conf
. Это уже сделано в современных дистрибутивах Linux, но, возможно, потребуется установить в более старых.
Pivy (обертки Python для Coin3d) не требуется для сборки FreeCAD или его запуска, но необходимы в качестве зависимости от среды выполнения для Draft Workbench. Если вы не собираетесь использовать эти инструментальные средства, вам не понадобится Pivy. Однако обратите внимание, что верстак Draft используется внутри других рабочих столов, таких как Arch и BIM, поэтому для использования этих инструментальных средств также необходимо установить Pivy.
К ноябрю 2015 года устаревшая версия Pivy, включенная в исходный код FreeCAD, больше не будет компилироваться во многих системах. Это не большая проблема, так как обычно вы должны получить Pivy от менеджера пакетов вашего дистрибутива; если вы не можете найти Pivy, вам, возможно, придется скомпилировать его самостоятельно, см. Инструкции по компиляции Pivy.
Для устранения неполадок в FreeCAD полезно иметь отладочные символы важных библиотек зависимостей, таких как Qt. Для этого попробуйте установить пакеты зависимостей, которые заканчиваются на -dbg
, -dbgsym
, -debuginfo
или аналогичные, в зависимости от вашего дистрибутива Linux.
Для Ubuntu вам, возможно, потребуется включить специальные репозитории, чтобы иметь возможность просматривать и устанавливать эти отладочные пакеты с помощью диспетчера пакетов. См.Debug Symbol Packages для получения дополнительной информации.
FreeCAD использует CMake в качестве основной системы сборки, она доступна во всех основных операционных системах. Компиляция с помощью CMake обычно очень проста и происходит в два этапа.
Makefile
, настроенный для второго шага. FreeCAD имеет несколько вариантов конфигурации на выбор, но он поставляется с разумными настройками по умолчанию. Некоторые альтернативы подробно описаны ниже.make
, которая генерирует исполняемые файлы FreeCAD.Поскольку FreeCAD - это крупное приложение, компиляция всего исходного кода может занять от 10 минут до одного часа, в зависимости от вашего процессора и количества ядер процессора, используемых для компиляции.
Для сборки из исходного кода просто создайте каталог сборки freecad-build
, отличный от вашей исходной папки FreeCAD, freecad-source
; затем из этой точки каталога сборки cmake
в нужную исходную папку. Вы также можете использовать cmake-gui
или ccmake
вместо cmake
в приведенных ниже инструкциях. Как только cmake
завершит конфигурацию среды, используйте make
для запуска актуальной компиляции.
# from your freecad-source folder:
mkdir build
cd build
cmake ../
make -j$(nproc --ignore=2)
Опция -j
make
определяет, сколько задач (файлов) компилируется параллельно. Программа nproc
выводит количество ядер процессора в вашей системе; используя ее вместе с опцией -j
, вы можете обработать столько файлов, сколько у вас ядер, чтобы ускорить общую компиляцию программы. В приведенном выше примере он будет использовать все ядра вашей системы, кроме двух; это позволит вашему компьютеру реагировать на другие виды использования, пока компиляция выполняется в фоновом режиме. Исполняемый файл FreeCAD в конечном итоге появится в каталоге freecad-build/bin
. См. также Compiling (speeding up) для повышения скорости компиляции.
If you have done a build before and get stuck on a dependency that is not recognized or can't seem to be resolved, try the following:
GNU libc 2.34 introduces a change to the library that can cause builds on some Linux systems to fail with an error like:
No rule to make target '/usr/lib/x86_64-linux-gnu/libdl.so
To resolve this, a symbolic link must be manually created from the (now empty) system-installed libdl.so.* to the location your compiler says it is looking for the file. For example (if the actual installed copy of libdl.so on your system is /usr/lib/x86_64-linux-gnu/libdl.so.2):
sudo ln -s /usr/lib/x86_64-linux-gnu/libdl.so.2 /usr/lib/x86_64-linux-gnu/libdl.so
Adapt the command for the structure of your system by searching for libdl.so* and linking it to the appropriate location.
Если вы случайно выполнили компиляцию в каталоге исходного кода или добавили странные файлы и хотели бы восстановить содержимое только в исходном исходном коде, вы можете выполнить следующие действия.
> .gitignore
git clean -df
git reset --hard HEAD
Первая строка очищает файл .gitignore
. Это гарантирует, что следующие команды clean и reset будут влиять на все в каталоге и не будут игнорировать элементы, соответствующие выражениям в .gitignore
. Вторая строка удаляет все файлы и каталоги, которые не отслеживаются репозиторием git, затем последняя команда сбрасывает все изменения в отслеживаемых файлах, включая первую команду, которая очистила файл .gitignore
.
Если вы не очистите исходный каталог, следующие запуски cmake
могут не включить новые параметры в систему, если код изменится.
Передавая различные параметры в cmake
, вы можете изменить способ компиляции FreeCAD. Синтаксис выглядит следующим образом.
cmake -D <var>:<type>=<value> $SOURCE_DIR
Где $SOURCE_DIR
- каталог, содержащий исходный код. <type>
в большинстве случаев может быть опущен. Пробел после параметра -D
также может быть опущен.
Например, чтобы избежать создания FEM Workbench:
cmake -D BUILD_FEM:BOOL=OFF ../
cmake -DBUILD_FEM=OFF ../
Все возможные переменные перечислены в файле InitializeFreeCADBuildOptions.cmake
, расположенном в каталоге CMake/FreeCAD_Helpers
. В этом файле найдёте слово option
, чтобы перейти к переменным, которые можно задать, и просмотреть их значения по умолчанию.
# ============================================================================== # ================= All the options for the build process ================= # ============================================================================== option(BUILD_FORCE_DIRECTORY "The build directory must be different to the source directory." OFF) option(BUILD_GUI "Build FreeCAD Gui. Otherwise you have only the command line and the Python import module." ON) option(FREECAD_USE_EXTERNAL_ZIPIOS "Use system installed zipios++ instead of the bundled." OFF) option(FREECAD_USE_EXTERNAL_SMESH "Use system installed smesh instead of the bundled." OFF) ...
В качестве альтернативы используйте команду cmake-LH
для отображения текущей конфигурации и, следовательно, всех переменных, которые можно изменить. Вы также можете установить и использовать cmake-gui
для запуска графического интерфейса, отображающего все переменные, которые можно изменить. В следующих разделах мы перечислим некоторые из наиболее важных опций, которые вы, возможно, захотите использовать.
Создайте сборку Debug
для устранения неполадок в FreeCAD. Имейте в виду, что при такой сборке Sketcher становится очень медленным при работе со сложными эскизами.
cmake -DPYTHON_EXECUTABLE=/usr/bin/python3 -DCMAKE_BUILD_TYPE=Debug ../
Создайте сборку Release
для тестирования кода, который не завершается сбоем. Сборка Release
будет выполняться намного быстрее, чем сборка Debug
.
cmake -DPYTHON_EXECUTABLE=/usr/bin/python3 -DCMAKE_BUILD_TYPE=Release ../
По умолчанию FreeCAD 0.19 и более ранние версии созданы для Python 2 и Qt4. Поскольку эти два пакета устарели, лучше создавать для Python 3 и Qt5. Поддержка Python 2 и Qt4 была удалена в FreeCAD 0.20, и нет необходимости явно включать Qt5 и Python 3 при компиляции последних версий разработки.
Для 0.20_dev:
cmake ../
Обратите внимание, что при переключении между сборками 0.19 и 0.20 может потребоваться удалить CMakeCache.txt до запуска cmake.
Если по умолчанию исполняемый файл python
в вашей системе является символической ссылкой на Python 2, cmake
попытается настроить FreeCAD для этой версии. Вы можете выбрать другую версию Python, указав путь к определенному исполняемому файлу:
cmake -DPYTHON_EXECUTABLE=/usr/bin/python3 ../
Если это не сработает, вам, возможно, придется определить дополнительные переменные, указывающие на требуемые библиотеки Python, и включить каталоги:
cmake -DPYTHON_EXECUTABLE=/usr/bin/python3.6 \
-DPYTHON_INCLUDE_DIR=/usr/include/python3.6m \
-DPYTHON_LIBRARY=/usr/lib/x86_64-linux-gnu/libpython3.6m.so \
-DPYTHON_PACKAGES_PATH=/usr/lib/python3.6/site-packages/ \
../
В одной системе, возможно, имеет несколько независимых версий Python, поэтому расположение и номера версий ваших файлов Python будут зависеть от вашего конкретного дистрибутива Linux. Используйте python3-V
для отображения версии Python, которую вы используете в настоящее время; необходимы только первые два числа; например, если результатом является Python 3.6.8
, вам необходимо указать каталоги, относящиеся к версии 3.6. Если вы не знаете нужных каталогов, попробуйте выполнить их поиск с помощью команды locate
.
locate python3.6
Вы можете использовать python3 -m site
в терминале для определения каталога site-packages
или dist-packages
для систем Debian.
Some components of FreeCAD, such as PySide, try to autodetect the most recent Python version installed on your system, which might fail if it is different from what you entered above. Adding the following cMake option might solve the issue:
-DPython3_FIND_STRATEGY=LOCATION
1. Запустите Qt Creator.
2. Кликните на Open Project.
3. Перейдите в каталог, в котором находится исходный код, freecad-source/
, и выберите самый верхний файл CMakeLists.txt
.
4. Выбрав файл, он автоматически запустит cmake
на нем, но может выйти из строя, если соответствующие параметры установлены неправильно.
5. Перейдите в Projects → Build & Run → Imported Kit → Build → Build Settings → CMake. Установите соответствующий каталог сборки, freecad-build/
.
6. Установите соответствующие переменные в диалоговом окне Key-Value типов String
и Bool
.
PYTHON_EXECUTABLE=/usr/bin/python3
7. Если переменные загружают проект неправильно, возможно, вам придется перейти к Projects → Manage Kits → Kits → Default (or Imported Kit or similar) → CMake Configuration. Затем нажмите Change, и добавьте соответствующую конфигурацию, как описано выше. Возможно, вам придется добавить дополнительные переменные о путях Python, если системный Python не найден.
PYTHON_EXECUTABLE:STRING=/usr/bin/python3.7
PYTHON_INCLUDE_DIR:STRING=/usr/include/python3.7m
PYTHON_LIBRARY:STRING=/usr/lib/x86_64-linux-gnu/libpython3.7m.so
PYTHON_PACKAGES_PATH:STRING=/usr/lib/python3.7/site-packages
7.1. Нажмите Apply, затем OK.
7.2. Убедитесь, что остальные параметры заданы правильно, например, Qt version должна быть текущей версией, установленной в системе, как Qt 5.9.5 in PATH (qt5)
.
Нажмите Apply, затем OK, чтобы закрыть конфигурацию.
Программа cmake
должна снова запуститься автоматически, и она должна заполнить весь диалог Key-Value всеми переменными, которые можно настроить.
8. Перейдите в Projects → Build & Run → Imported Kit → Run → Run Settings → Run → Run Configuration и выберите FreeCADMain
для компиляции графической версии FreeCAD или FreeCADMainCMD
для компиляции только версии командной строки.
9. Наконец, перейдите в меню Сборка → Проект сборки "FreeCAD". Если это новая компиляция, она должна занять несколько минут, включительно часов, в зависимости от количества доступных процессоров.
Если Вы хотите разрабатывать Qt-код для FreeCAD, Вам понадобится плагин к Qt Designer, который обеспечивает все пользовательские виджеты FreeCAD.
Перейдите в дополнительный каталог исходного кода, запустите qmake
с указанным файлом проекта для создания Makefile
; затем запустите make
для компиляции плагина.
cd freecad-source/src/Tools/plugins/widget
qmake plugin.pro
make
Если вы компилируете для Qt5, убедитесь, что двоичный файл qmake
предназначен для этой версии, чтобы результирующий Makefile
содержал необходимую информацию для Qt5.
cd freecad-source/src/Tools/plugins/widget
$QT_DIR/bin/qmake plugin.pro
make
где $QT_DIR
- это каталог, в котором хранятся двоичные библиотеки Qt, например, /usr/lib/x86_64-linux-gnu/qt5
.
Созданная библиотека libFreeCAD_widgets.so
, которую необходимо скопировать в $QT_DIR/плагины/конструктор
.
sudo cp libFreeCAD_widgets.so $QT_DIR/plugins/designer
В прошлом, версия Pivy была включена в исходный код FreeCAD (internal). Если вы хотели использовать системную копию Pivy (external), вам нужно было использовать -DFREECAD_USE_EXTERNAL_PIVY=1
.
Использование внешнего Pivy стало по умолчанию во время разработки FreeCAD 0.16, поэтому эту опцию больше не нужно устанавливать вручную.
Если у вас установлен Doxygen, вы можете создать документацию по исходному коду. См. инструкции в source documentation.
Исходный код FreeCAD очень обширен, и с помощью CMake можно настроить множество параметров. Обучение полному использованию CMake может быть полезно для выбора правильных вариантов для ваших особых потребностей.
от Kitware.
(блог), предварительно изучив программирование.
(блог) , предварительно изучив программирование.
Если Вы планируете собрать пакет Debian вне исходников, вам следует сначала установить следующие пакеты:
sudo apt install dh-make devscripts lintian
Перейдите в папку FreeCAD и выполните
debuild
Когда пакет построен, Вы можете использовать lintian
для проверки, содержит ли пакет ошибки
lintian freecad-package.deb
The Debian script checkinstall
allows to create a *.deb package that can be installed and removed with the standard dpkg
commands. It may need to be installed first (on Ubuntu use sudo apt install checkinstall
). It's interactive and asks for the required information providing helpful defaults. During the process the package is installed and a *.deb file and a backup archive are created.
It's a good idea to define a name and a short description for the package. The name must be entered to uninstall it again and the desription will be listed by dpkg -l
. The default name "build" is not very informative.
Example:
cd freecad-source/build
cmake ..
make
sudo checkinstall # e.g. name=freecad-test1
The result is a *.deb file in the build folder. checkinstall
will install the build by default. This is how you can install or uninstall it:
cd freecad-source/build
ls | grep freecad
freecad-test1_20220814-1_amd64.deb
sudo dpkg -i freecad-test1_20220814-1_amd64.deb # install
dkpg -l | grep freecad # find by name
sudo dpkg -r freecad-test1 # uninstall by name
Система CMake позволяет разумно обновлять исходный код и перекомпилировать только то, что изменилось, что ускоряет следующие компиляции.
Перейдите в то место, где исходный код FreeCAD был впервые загружен, и извлеките новый код:
cd freecad-source
git pull
Затем перейдите в каталог сборки, в котором код был скомпилирован изначально, и запустите cmake
, указав текущий каталог (denoted by a dot); затем запустите повторную компиляцию с помощью make
.
cd build
cmake ../
make -j$(nproc --ignore=2)
In case the compiled source code was installed with sudo make install
(for Debian) the files were copied to the /usr/local folder into several subfolders. For uninstallation the file install_manifest.txt can be used. It has been created into the build folder during compilation and contains all installed files. As long as this file exists, the installation can be uninstalled.
cd freecad-source/build
xargs sudo rm < install_manifest.txt
При компиляции FreeCAD на 64-бит известна проблема с 64-битным пакетом OpenCASCADE. Чтобы FreeCAD правильно заработал, Вам нужно запустить скрипт configure
и установить дополнительно CXXFLAGS
:
./configure CXXFLAGS="-D_OCC64"
Для систем на базе Debian эта опция не требуется при использовании готовых пакетов OpenCASCADE, поскольку эти пакеты устанавливают правильно CXXFLAGS
внутри.
Это всё, что Вам нужно для полной компиляции FreeCAD. Это односкриптовое решение, работающее на свежеустановленном дистрибутиве. Команда запросит пароль root для установки пакетов новых онлайновых репозиториев. Эти скрипты должны запускаться на 32- и 64-битных версиях. Они написаны для разных версий, но, скорее всего, будут работать для позднейший версий с небольшими изменениями или без них.
Если у вас есть такой скрипт для вашего выбранного дистрибутива, пожалуйста, обсудите его на Форум FreeCAD, чтобы мы могли его включить.
Эти скрипты обеспечивают надёжный путь для установки верного набора зависимостей, требуемых для сборки и запуска FreeCAD в Ubuntu. Они используют репозитории PPA Ubuntu FreeCAD, и должны работать на любой версии Ubuntu, для которой есть целевой PPA. PPA на freecad-daily нацелен на последнюю версию Ubuntu, а 'стабильный' PPA нацелен на официально поддерживаемые версии Ubuntu.
Этот скрипт устанавливает дневной скомпилированный снимок FreeCAD и его зависимостей. Он добавляет дневной репозиторий, получает зависимости для создания этой версии и устанавливает необходимые пакеты. Затем он продолжает извлекать исходный код в определенный каталог, создает каталог сборки и вносит в него изменения, настраивает среду компиляции с помощью cmake
и, наконец, создает всю программу с помощью make
. Сохраните сценарий в файл, сделайте его исполняемым и запустите его, но не используйте sudo
; привилегии суперпользователя будут запрашиваться только для выбранных команд.
#!/bin/sh
sudo add-apt-repository --enable-source ppa:freecad-maintainers/freecad-daily && sudo apt-get update
sudo apt-get build-dep freecad-daily
sudo apt-get install freecad-daily
git clone --recurse-submodules https://github.com/FreeCAD/FreeCAD.git freecad-source
mkdir freecad-source/build
cd freecad-source/build
cmake -DPYTHON_EXECUTABLE=/usr/bin/python3 -DFREECAD_USE_PYBIND11=ON ../
make -j$(nproc --ignore=2)
При желании вы можете удалить предварительно скомпилированную версию FreeCAD (freecad-daily
), оставив зависимости на месте, однако, если этот пакет будет установлен, менеджер пакетов также сможет обновлять свои зависимости; это наиболее полезно, если вы намерены следить за развитием FreeCAD, а также постоянно обновлять и компилировать исходные тексты из репозитория Git.
Предыдущий скрипт предполагает, что вы хотите скомпилировать последнюю версию FreeCAD, поэтому вы используете репозиторий "daily" для получения зависимостей. Однако вместо этого вы можете получить зависимости сборки "стабильной" версии для вашего текущего выпуска Ubuntu. Если это так, замените верхнюю часть предыдущего сценария следующими инструкциями. Для Ubuntu 12.04 опустите --enable-source
в команде.
#!/bin/sh
sudo add-apt-repository --enable-source ppa:freecad-maintainers/freecad-stable && sudo apt-get update
sudo apt-get build-dep freecad
sudo apt-get install libqt5xmlpatterns5-dev # Needed for 0.20; should go away on next packaging update
sudo apt-get install freecad
Как только вы установите пакет freecad
из репозитория freecad-stable
, он заменит исполняемый файл FreeCAD, доступный из репозитория Ubuntu Universe. Исполняемый файл будет называться просто freecad
, а не freecad-stable
.
Никаких внешних репозиториев не требуется для компиляции FreeCAD. Однако существует несовместимость с python3-devel, которую необходимо удалить. FreeCAD может быть скомпилирован из GIT
# install needed packages for development
sudo zypper install gcc cmake OpenCASCADE-devel libXerces-c-devel \
python-devel libqt4-devel python-qt4 Coin-devel SoQt-devel boost-devel \
libode-devel libQtWebKit-devel libeigen3-devel gcc-fortran git swig
# create new dir, and go into it
mkdir FreeCAD-Compiled
cd FreeCAD-Compiled
# get the source
git clone --recurse-submodules https://github.com/FreeCAD/FreeCAD.git free-cad
# Now you will have a subfolder in this location called free-cad. It contains the source
# make another dir for compilation, and go into it
mkdir FreeCAD-Build1
cd FreeCAD-Build1
# build configuration
cmake ../free-cad
# build FreeCAD
make
# test FreeCAD
cd bin
./FreeCAD -t 0
Поскольку вы используете git, в следующий раз, когда захотите скомпилировать, вам не нужно клонировать все подряд просто извлеките из git и скомпилируйте еще раз
# go into free-cad dir created earlier
cd free-cad
# pull
git pull
# get back to previous dir
cd ..
# Now repeat last few steps from before.
# make another dir for compilation, and go into it
mkdir FreeCAD-Build2
cd FreeCAD-Build2
# build configuration
cmake ../free-cad
# build FreeCAD
# Note: to speed up build use all CPU cores: make -j$(nproc)
make
# test FreeCAD
cd bin
./FreeCAD -t 0
# get the needed tools and libs
sudo apt-get install build-essential python libcoin60-dev libsoqt4-dev \
libxerces-c2-dev libboost-dev libboost-date-time-dev libboost-filesystem-dev \
libboost-graph-dev libboost-iostreams-dev libboost-program-options-dev \
libboost-serialization-dev libboost-signals-dev libboost-regex-dev \
libqt4-dev qt4-dev-tools python2.5-dev \
libsimage-dev libopencascade-dev \
libsoqt4-dev libode-dev subversion cmake libeigen2-dev python-pivy \
libtool autotools-dev automake gfortran
# checkout the latest source
git clone --recurse-submodules https://github.com/FreeCAD/FreeCAD.git freecad
# go to source dir
cd freecad
# build configuration
cmake .
# build FreeCAD
# Note: to speed up build use all CPU cores: make -j$(nproc)
make
# test FreeCAD
cd bin
./FreeCAD -t 0
Опубликовано пользователем [PrzemoF] на форуме.
#!/bin/bash
ARCH=$(arch)
MAIN_DIR=FreeCAD
BUILD_DIR=build
#FEDORA_VERSION=27
#FEDORA_VERSION=28
FEDORA_VERSION=29
PACKAGES="gcc cmake gcc-c++ boost-devel zlib-devel swig eigen3 qt-devel \
shiboken shiboken-devel pyside-tools python-pyside python-pyside-devel xerces-c \
xerces-c-devel OCE-devel smesh graphviz python-pivy python-matplotlib tbb-devel \
freeimage-devel Coin3 Coin3-devel med-devel vtk-devel"
FEDORA_29_PACKAGES="boost-python2 boost-python3 boost-python2-devel boost-python3-devel"
if [ "$FEDORA_VERSION" = "29" ]; then
PACKAGES="$PACKAGES $FEDORA_29_PACKAGES"
fi
echo "Installing packages required to build FreeCAD"
sudo dnf -y install $PACKAGES
cd ~
mkdir $MAIN_DIR || { echo "~/$MAIN_DIR already exist. Quitting.."; exit; }
cd $MAIN_DIR
git clone --recurse-submodules https://github.com/FreeCAD/FreeCAD.git
mkdir $BUILD_DIR || { echo "~/$BUILD_DIR already exist. Quitting.."; exit; }
cd $BUILD_DIR
cmake ../FreeCAD
make -j$(nproc)
Arch User Repository (AUR) - это коллекция пользовательских рецептов для создания пакетов, которые официально не поддерживаются сопровождающими распространения / сообществом. Обычно они в безопасности. Вы можете увидеть, кто поддерживал посылку и как долго он это делал. Рекомендуется проверить общестроительные файлы. Также в этой области доступно программное обеспечение с открытым исходным кодом, даже если оно поддерживается официальной компанией-владельцем.
Обязательное требование : git
Шаги :
mkdir git
. При необходимости измените каталог, например. cd git
.git clone http://aur.archlinux.org/packages/freecad-git
cd freecad-git
makepkg -s
. Флаг -s или --syncdeps также установит необходимые зависимости.makepkg --install
или дважды щелкните имя файла pkgname-pkgver.pkg.tar.xz в вашем браузере файлов.Чтобы обновить FreeCAD до последней версии, просто повторите шаг 3. Обновите репозиторий, когда в рецепте произойдет какое-либо изменение или появятся новые функции, используя git checkout-f
внутри каталога.